Add docs for the row-activated signal. (#324044, Davyd Madeley)

2005-12-14  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtktreeview.c (gtk_tree_view_class_init): Add docs
	for the row-activated signal.  (#324044, Davyd Madeley)

diff --git a/ChangeLog b/ChangeLog
index c3a619d99f1ce6377007162fd2c3d825089dc5ec..8f93318ec2c51f4b7140473c2d5aeace4244f76f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,10 +1,15 @@
+2005-12-14  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreeview.c (gtk_tree_view_class_init): Add docs 
+       for the row-activated signal.  (#324044, Davyd Madeley)
+
 2005-12-14  Michael Natterer  <mitch@imendio.com>
 
        * tests/test-images/valid_jpeg_progressive_test: new test image.
 
 Tue Dec 13 09:47:20 2005  Tim Janik  <timj@gtk.org>
 
-       * README.in: added a link to the fgloating reference docs in the
+       * README.in: added a link to the floating reference docs in the
        2.10 release NEWS section.
 
 2005-12-12  Matthias Clasen  <mclasen@redhat.com>

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index c3a619d99f1ce6377007162fd2c3d825089dc5ec..8f93318ec2c51f4b7140473c2d5aeace4244f76f 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,10 +1,15 @@
+2005-12-14  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreeview.c (gtk_tree_view_class_init): Add docs 
+       for the row-activated signal.  (#324044, Davyd Madeley)
+
 2005-12-14  Michael Natterer  <mitch@imendio.com>
 
        * tests/test-images/valid_jpeg_progressive_test: new test image.
 
 Tue Dec 13 09:47:20 2005  Tim Janik  <timj@gtk.org>
 
-       * README.in: added a link to the fgloating reference docs in the
+       * README.in: added a link to the floating reference docs in the
        2.10 release NEWS section.
 
 2005-12-12  Matthias Clasen  <mclasen@redhat.com>

diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index c9abeabbfda8327c8dd5001f7fc2573e751d22f8..48b0637537e18c21626da5dd25db617043da1180 100644 (file)
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -778,6 +778,21 @@ gtk_tree_view_class_init (GtkTreeViewClass *class)
                  GTK_TYPE_ADJUSTMENT,
                  GTK_TYPE_ADJUSTMENT);
 
+  /**
+   * GtkTreeView::row-activated:
+   * @tree_view: the object on which the signal is emitted
+   * @path: the #GtkTreePath for the activated row
+   * @column: the #GtkTreeViewColumn in which the activation occurred
+   *
+   * The "row-activated" signal is emitted when the method
+   * gtk_tree_view_row_activated() is called or the user double clicks 
+   * a treeview row. It is also emitted when a non-editable row is 
+   * selected and one of the keys: Space, Shift+Space, Return or 
+   * Enter is pressed.
+   * 
+   * For selection handling refer to the <link linkend="TreeWidget">tree 
+   * widget conceptual overview</link> as well as #GtkTreeSelection.
+   */
   tree_view_signals[ROW_ACTIVATED] =
     g_signal_new (I_("row_activated"),
                  G_TYPE_FROM_CLASS (o_class),